home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmRepTypeRegister.z
/
XmRepTypeRegister
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr - A representation type manager function
that registers a representation type resource
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/RepType.h>
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeIIIIdddd XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr(
SSSSttttrrrriiiinnnngggg rrrreeeepppp____ttttyyyyppppeeee,
SSSSttttrrrriiiinnnngggg ****vvvvaaaalllluuuueeee____nnnnaaaammmmeeeessss,
uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr ****vvvvaaaalllluuuueeeessss,
uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr nnnnuuuummmm____vvvvaaaalllluuuueeeessss);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr registers a representation type resource
with the representation type manager. All features of the
representation type management facility become available for
the specified representation type. The function installs a
forward type converter to convert string values to numerical
representation type values.
When the _v_a_l_u_e_s argument is NULL, consecutive numerical
values are assumed. The order of the strings in the
_v_a_l_u_e__n_a_m_e_sarray determines the numerical values for the
resource. For example, the first value name is 0 (zero); the
second value name is 1; and so on.
If it is non-NULL, the _v_a_l_u_e_s argument can be used to assign
values to representation types that have nonconsecutive
values or have duplicate names for the same value.
Representation types registered in this manner will consume
additional storage and will be slightly slower than
representation types with consecutive values.
A representation type can only be registered once; if the
same representation type name is registered more than once,
the behavior is undefined.
The function XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeAAAAddddddddRRRReeeevvvveeeerrrrsssseeee installs a reverse
converter for a registered representation type. The reverse
converter takes a representation type numerical value and
returns the corresponding string value. If the list of
numerical values for a representation type contains
duplicate values, the reverse converter uses the first name
in the _v_a_l_u_e__n_a_m_e_s list that matches the specified numeric
value. For example, if a _v_a_l_u_e__n_a_m_e_s array has _c_a_n_c_e_l,
_p_r_o_c_e_e_d, and _a_b_o_r_t, and the corresponding _v_a_l_u_e_s array
contains 0, 1, and 0, the reverse converter will return
_c_a_n_c_e_linstead of _a_b_o_r_t for an input value of 0.
Page 1 (printed 10/24/98)
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX))))
_r_e_p__t_y_p_e Specifies the representation type name.
_v_a_l_u_e__n_a_m_e_s
Specifies a pointer to an array of value names
associated with the representation type. A value
name is specified in lowercase characters without
an XXXXmmmm prefix. Words within a name are separated
with underscores.
_v_a_l_u_e_s Specifies a pointer to an array of values
associated with the representation type. A value
in this array is associated with the value name in
the corresponding position of the
_v_a_l_u_e__n_a_m_e_sarray.
_n_u_m__v_a_l_u_e_s
Specifies the number of entries in the _v_a_l_u_e__n_a_m_e_s
and _v_a_l_u_e_s arrays.
RRRREEEETTTTUUUURRRRNNNN
Returns the identification number for the specified
representation type.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeAAAAddddddddRRRReeeevvvveeeerrrrsssseeee(3), XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttIIIIdddd(3),
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttNNNNaaaammmmeeeeLLLLiiiisssstttt(3), XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttRRRReeeeccccoooorrrrdddd(3),
XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttRRRReeeeggggiiiisssstttteeeerrrreeeedddd(3), and XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeVVVVaaaalllliiiiddddVVVVaaaalllluuuueeee(3).
Page 2 (printed 10/24/98)